home *** CD-ROM | disk | FTP | other *** search
/ isnet Internet / Isnet Internet CD.iso / prog / hiz / 09 / 09.exe / adynware.exe / perl / lib / Fcntl.pm < prev    next >
Encoding:
Perl POD Document  |  1999-12-28  |  2.7 KB  |  96 lines
  1. package Fcntl;
  2.  
  3. =head1 NAME
  4.  
  5. Fcntl - load the C Fcntl.h defines
  6.  
  7. =head1 SYNOPSIS
  8.  
  9.     use Fcntl;
  10.     use Fcntl qw(:DEFAULT :flock);
  11.  
  12. =head1 DESCRIPTION
  13.  
  14. This module is just a translation of the C F<fnctl.h> file.
  15. Unlike the old mechanism of requiring a translated F<fnctl.ph>
  16. file, this uses the B<h2xs> program (see the Perl source distribution)
  17. and your native C compiler.  This means that it has a 
  18. far more likely chance of getting the numbers right.
  19.  
  20. =head1 NOTE
  21.  
  22. Only C<#define> symbols get translated; you must still correctly
  23. pack up your own arguments to pass as args for locking functions, etc.
  24.  
  25. =head1 EXPORTED SYMBOLS
  26.  
  27. By default your system's F_* and O_* constants (eg, F_DUPFD and
  28. O_CREAT) and the FD_CLOEXEC constant are exported into your namespace.
  29.  
  30. You can request that the flock() constants (LOCK_SH, LOCK_EX, LOCK_NB
  31. and LOCK_UN) be provided by using the tag C<:flock>.  See L<Exporter>.
  32.  
  33. You can request that the old constants (FAPPEND, FASYNC, FCREAT,
  34. FDEFER, FEXCL, FNDELAY, FNONBLOCK, FSYNC, FTRUNC) be provided for
  35. compatibility reasons by using the tag C<:Fcompat>.  For new
  36. applications the newer versions of these constants are suggested
  37. (O_APPEND, O_ASYNC, O_CREAT, O_DEFER, O_EXCL, O_NDELAY, O_NONBLOCK,
  38. O_SYNC, O_TRUNC).
  39.  
  40. Please refer to your native fcntl() and open() documentation to see
  41. what constants are implemented in your system.
  42.  
  43. =cut
  44.  
  45. use vars qw($VERSION @ISA @EXPORT @EXPORT_OK %EXPORT_TAGS $AUTOLOAD);
  46.  
  47. require Exporter;
  48. require DynaLoader;
  49. @ISA = qw(Exporter DynaLoader);
  50. $VERSION = "1.03";
  51. @EXPORT =
  52.   qw(
  53.      F_DUPFD F_GETFD F_GETLK F_SETFD F_GETFL F_SETFL F_SETLK F_SETLKW
  54.      FD_CLOEXEC F_RDLCK F_UNLCK F_WRLCK F_POSIX
  55.      O_CREAT O_EXCL O_NOCTTY O_TRUNC
  56.      O_APPEND O_NONBLOCK
  57.      O_NDELAY O_DEFER
  58.      O_RDONLY O_RDWR O_WRONLY
  59.      O_BINARY O_TEXT
  60.      O_EXLOCK O_SHLOCK O_ASYNC O_DSYNC O_RSYNC O_SYNC
  61.      F_SETOWN F_GETOWN
  62.      );
  63.  
  64. @EXPORT_OK = qw(
  65.     LOCK_SH LOCK_EX LOCK_NB LOCK_UN
  66.     FAPPEND FASYNC FCREAT FDEFER FEXCL FNDELAY FNONBLOCK FSYNC FTRUNC
  67. );
  68. %EXPORT_TAGS = (
  69.     'flock'   => [qw(LOCK_SH LOCK_EX LOCK_NB LOCK_UN)],
  70.     'Fcompat' => [qw(FAPPEND FASYNC FCREAT FDEFER FEXCL
  71.                    FNDELAY FNONBLOCK FSYNC FTRUNC)],
  72. );
  73.  
  74. sub AUTOLOAD {
  75.     my($constname);
  76.     ($constname = $AUTOLOAD) =~ s/.*:://;
  77.     my $val = constant($constname, @_ ? $_[0] : 0);
  78.     if ($! != 0) {
  79.     if ($! =~ /Invalid/) {
  80.         $AutoLoader::AUTOLOAD = $AUTOLOAD;
  81.         goto &AutoLoader::AUTOLOAD;
  82.     }
  83.     else {
  84.         my ($pack,$file,$line) = caller;
  85.         die "Your vendor has not defined Fcntl macro $constname, used at $file line $line.
  86. ";
  87.     }
  88.     }
  89.     eval "sub $AUTOLOAD { $val }";
  90.     goto &$AUTOLOAD;
  91. }
  92.  
  93. bootstrap Fcntl $VERSION;
  94.  
  95. 1;
  96.